TabPanel Class

Use the Value property to get and set the tab panel being displayed. The first panel is numbered zero. The TabPanel control is subclassed from PagePanel; the Value property is described there.

You get or set the panel on which a control is located via the PanelIndex property of the RectControl class. The first panel is numbered zero.

Adding, Labelling, and Renaming Tabs

Click the value of the Panels property of the TabPanel to display the Tab Panel editor. From this screen, you can:

Rename the existing tab labels by clicking twice on its name and editing the name.

Add tabs and their labels by clicking the Add button.

Delete any tab by highlighting it and clicking Delete.

Rearrange the tabs by highlighting a tab and clicking the Up or Down buttons.

You add controls to a particular panel by clicking its tab and dragging controls to that panel.

Facings and SmallTabs

The Facings property lets you place the tabs on any side of the TabPanel. The SmallTabs property reduces the vertical (North or South) or horizontal (East or West) size of the tabs.

Placing Controls on Tab Panels

You can place other controls on the surface of any tab panel. Such controls are visible only when the user clicks on that panel's tab to bring it to the front. You can use the TabPanelIndex property of the Control class to read the panel on which the control is located. You cannot move a control to another panel via code. Please note that TabPanelIndex may be superseded by another way of reading a control's 'parent' object and code that uses TabPanelIndex may have to be rewritten.

Placing TabPanels within other TabPanels, PagePanels within PagePanels, TabPanels within PagePanels, and vice versa are not officially supported.

If the Caption property contains an ampersand character, it will display only if it is preceded by another ampersand character. This is done to make applications on all platforms behave consistently. The ampersand character is used to indicate the keyboard accelerator on Windows.